desc:instruct
npx @tomtom-org/tomtom-mcp
Parameter | Type | Required | Description |
---|---|---|---|
query | string | Required | Full address to convert to coordinates. Include as much detail as possible (street, city, country) for accurate results. Examples: '1600 Pennsylvania Ave, Washington DC', 'Eiffel Tower, Paris, France' |
limit | number | Optional | Maximum number of results to return (1-100). Default: 5 |
language | string | Optional | Preferred language for results using IETF language tags. Examples: 'en-US', 'fr-FR', 'de-DE', 'es-ES' |
countrySet | string | Optional | Limit results to specific countries using ISO codes. Examples: 'US', 'FR,GB', 'CA,US' |
view | string | Optional | Geopolitical view for disputed territories. Options: 'Unified', 'AR', 'IL', 'IN', 'MA', 'PK', 'RU', 'TR', 'CN' |
extendedPostalCodesFor | string | Optional | Include extended postal codes for specific index types. Examples: 'PAD', 'PAD,Addr', 'POI' |
mapcodes | array<string> | Optional | Include mapcode information in the response. Mapcodes represent specific locations within a few meters and are designed to be short, easy to recognize and communicate. Options: Local, International, Alternative. Examples: 'Local' (local mapcode only), 'Local,Alternative' (multiple types). Accepts array of string(s). |
timeZone | string | Optional | Used to indicate the mode in which the timeZone object should be returned. Values: iana Mode shows the IANA ID which allows the user to determine the current time zone for the POI. Usage examples: timeZone=iana |
geometries | boolean | Optional | Include geometries information in the response |
addressRanges | boolean | Optional | Include address ranges in the response |
lat | number | Optional | Center latitude for location bias |
lon | number | Optional | Center longitude for location bias |
radius | number | Optional | Search radius in meters when lat/lon provided |
topLeft | string | Optional | Top-left coordinates of bounding box (format: 'lat,lon'). Must be used with btmRight |
btmRight | string | Optional | Bottom-right coordinates of bounding box (format: 'lat,lon'). Must be used with topLeft |
entityTypeSet | string | Optional | Filter results by geographic entity types. Valid values: PostalCodeArea, CountryTertiarySubdivision, CountrySecondarySubdivision, MunicipalitySubdivision, MunicipalitySecondarySubdivision, Country, CountrySubdivision, Neighbourhood, Municipality. Note: This parameter is for geographic entities only, not POIs. For POI filtering, use categorySet instead |